home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / cut.z / cut
Encoding:
Text File  |  1998-10-20  |  9.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ccccuuuutttt((((1111))))                                                                  ccccuuuutttt((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      _cccc_uuuu_tttt - cut out selected fields of each line of a file
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      _cccc_uuuu_tttt _----_bbbb _l_i_s_t [_----_nnnn] [_f_i_l_e . . .]
  13.      _cccc_uuuu_tttt _----_cccc _l_i_s_t _[[[[_f_i_l_e _...._...._...._]]]]
  14.      _cccc_uuuu_tttt _----_ffff _l_i_s_t [_----_dddd _c_h_a_r] [_----_ssss] [_f_i_l_e . . .]
  15.  
  16. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.      Use _cccc_uuuu_tttt to cut out columns from a table or fields from each line of a
  18.      file; in data base parlance, it implements the projection of a relation.
  19.      The fields as specified by _l_i_s_t can be fixed length, that is, character
  20.      positions as on a punched card (_----_cccc option) or the length can vary from
  21.      line to line and be marked with a field delimiter character like _t_a_b (_----_ffff
  22.      option).  _cccc_uuuu_tttt can be used as a filter; if no files are given, the
  23.      standard input is used.  A file name of ``_----'' explicitly refers to
  24.      standard input.
  25.  
  26.      _cccc_uuuu_tttt processes supplementary code set characters, and recognizes
  27.      supplementary code set characters in the _c_h_a_r given to the _----_dddd option (see
  28.      below) according to the locale specified in the _LLLL_CCCC______CCCC_TTTT_YYYY_PPPP_EEEE environment
  29.      variable [see _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5)].  For special treatment of multibyte
  30.      characters, see the _----_cccc_l_i_s_t option below.
  31.  
  32.      The meanings of the options are:
  33.  
  34.      _l_i_s_t     A comma-separated list or blank-separated list of positive
  35.               numbers and ranges.  Ranges have three forms.  The first is two
  36.               positive integers separated by a hyphen (_l_o_w-_h_i_g_h), which
  37.               represents all fields from _l_o_w to _h_i_g_h.  The second is a
  38.               positive number preceded by a hyphen (-_h_i_g_h), which represents
  39.               all fields from field _1 to _h_i_g_h.  The last is a positive number
  40.               followed by a hyphen (_l_o_w-), which represents all fields from
  41.               _l_o_w to the last field, inclusive.  Elements in the list can be
  42.               repeated, can overlap, and can appear in any order.
  43.  
  44.      _----_bbbb _l_i_s_t  Cut based on a _l_i_s_t of bytes.  Each selected byte will be output
  45.               unless the -_n option is also specified.  Bytes specified need
  46.               not be present in the input.
  47.  
  48.      _----_cccc _l_i_s_t  Cut based on a _l_i_s_t of characters.  Each selected character will
  49.               be output.  Characters specified need not be present in the
  50.               input.
  51.  
  52.      _----_dddd       The character following _----_dddd is the field delimiter (_----_ffff option
  53.               only).  Default is _t_a_b.  Space or other characters with special
  54.               meaning to the shell must be quoted.  _c_h_a_r may be a
  55.               supplementary code set character.
  56.  
  57.      _----_ffff_l_i_s_t   The _l_i_s_t following _----_ffff is a list of fields assumed to be
  58.               separated in the file by a delimiter character (see _----_dddd ); for
  59.               example, _----_ffff_1111_,,,,_7777 copies the first and seventh field only.  Lines
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccuuuutttt((((1111))))                                                                  ccccuuuutttt((((1111))))
  71.  
  72.  
  73.  
  74.               with no field delimiters will be passed through intact (useful
  75.               for table subheadings), unless _----_ssss is specified.  Fields
  76.               specified need not be present in the input.
  77.  
  78.      _----_nnnn       Do not split characters.  When specified with the -_b option, all
  79.               characters ending within the range are passed to the output.
  80.  
  81.      _----_ssss       Suppresses lines with no delimiter characters in case of _----_ffff
  82.               option.  Unless specified, lines with no delimiters will be
  83.               passed through untouched.
  84.  
  85.      Either the _----_cccc or _----_ffff option must be specified.
  86.  
  87.      Use _gggg_rrrr_eeee_pppp(1) to make horizontal ``cuts'' (by context) through a file, or
  88.      _pppp_aaaa_ssss_tttt_eeee(1) to put files together column-wise (that is, horizontally).  To
  89.      reorder columns in a table, use _cccc_uuuu_tttt and _pppp_aaaa_ssss_tttt_eeee.
  90.  
  91. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  92.      _cccc_uuuu_tttt _----_dddd_:::: _----_ffff_1111_,,,,_5555 _////_eeee_tttt_cccc_////_pppp_aaaa_ssss_ssss_wwww_dddd
  93.                            mapping of user IDs to names
  94.  
  95.      _nnnn_aaaa_mmmm_eeee_====_````_wwww_hhhh_oooo _aaaa_mmmm _iiii _|||| _cccc_uuuu_tttt _----_ffff_1111 _----_dddd_"""" _""""_````
  96.                            to set _nnnn_aaaa_mmmm_eeee to current login name.
  97.  
  98. FFFFIIIILLLLEEEESSSS
  99.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_llll_oooo_cccc_aaaa_llll_eeee_////_l_o_c_a_l_e_////_LLLL_CCCC______MMMM_EEEE_SSSS_SSSS_AAAA_GGGG_EEEE_SSSS_////_uuuu_xxxx_cccc_oooo_rrrr_eeee
  100.           language-specific message file [See _LLLL_AAAA_NNNN_GGGG on _eeee_nnnn_vvvv_iiii_rrrr_oooo_nnnn(5).]
  101.  
  102. EEEEXXXXTTTTEEEENNNNDDDDEEEEDDDD DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  103.      X/Open CAE Specification(1994)--Commands and Utilities.
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      _gggg_rrrr_eeee_pppp(1), _pppp_aaaa_ssss_tttt_eeee(1)
  107.  
  108. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  109.      _UUUU_XXXX_::::_cccc_uuuu_tttt_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_llll_iiii_nnnn_eeee _tttt_oooo_oooo _llll_oooo_nnnn_gggg
  110.                  A line can have no more than 1023 bytes or fields, or there
  111.                  is no new-line character.
  112.  
  113.      _UUUU_XXXX_::::_cccc_uuuu_tttt_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_bbbb_aaaa_dddd _llll_iiii_ssss_tttt _ffff_oooo_rrrr _cccc_////_ffff _oooo_pppp_tttt_iiii_oooo_nnnn
  114.                  Missing _----_cccc or _----_ffff option or incorrectly specified _l_i_s_t.  No
  115.                  error occurs if a line has fewer fields than the _l_i_s_t calls
  116.                  for.
  117.  
  118.      _UUUU_XXXX_::::_cccc_uuuu_tttt_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_nnnn_oooo _ffff_iiii_eeee_llll_dddd_ssss
  119.                  The _l_i_s_t is empty.
  120.  
  121.      _UUUU_XXXX_::::_cccc_uuuu_tttt_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_nnnn_oooo _dddd_eeee_llll_iiii_mmmm_iiii_tttt_eeee_rrrr
  122.                  Missing _c_h_a_r on _----_dddd option.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccuuuutttt((((1111))))                                                                  ccccuuuutttt((((1111))))
  137.  
  138.  
  139.  
  140.      _UUUU_XXXX_::::_cccc_uuuu_tttt_::::_EEEE_RRRR_RRRR_OOOO_RRRR_::::_cccc_aaaa_nnnn_nnnn_oooo_tttt _hhhh_aaaa_nnnn_dddd_llll_eeee _mmmm_uuuu_llll_tttt_iiii_pppp_llll_eeee _aaaa_dddd_jjjj_aaaa_cccc_eeee_nnnn_tttt _bbbb_aaaa_cccc_kkkk_ssss_pppp_aaaa_cccc_eeee_ssss
  141.                  Adjacent backspaces cannot be processed correctly.
  142.  
  143.      _UUUU_XXXX_::::_cccc_uuuu_tttt_::::_WWWW_AAAA_RRRR_NNNN_IIII_NNNN_GGGG_::::_cccc_aaaa_nnnn_nnnn_oooo_tttt _oooo_pppp_eeee_nnnn _<<<<_f_i_l_e_n_a_m_e_>>>>
  144.                  Either _f_i_l_e_n_a_m_e cannot be read or does not exist.  If
  145.                  multiple filenames are present, processing continues.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.